home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 36 - Archivers (19xx)(Topik Public Domain)(PD)[WB].adf / Zippy / Zippy.doc < prev    next >
Text File  |  1990-10-07  |  17KB  |  373 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.            __________
  15.           /_________/\     _
  16.                    / /    / \
  17.                   / /     \_/
  18.                  / /        _      _____        _____
  19.                 / /        /|     /|___ \      /|___ \    /\      /\
  20.                / /        / |    / |   \ \    / |   \ \   \ \    / /
  21.               / /         | |    | |    \ \   | |    \ \   \ \  / /
  22.              / /          | |    | |    / /   | |    / /    \ \/ /
  23.             / /           | |    | |___/ /    | |___/ /      \/ /
  24.            / /_________   | /    | |____/     | |____/       / /
  25.            \/_________/   |/     | |          | |           / /
  26.                                  | |          | |  Version / / 1.25
  27.           An Amiga UnZip Utility | /          | /         / /
  28.                                  |/           |/          \/
  29.  
  30.                         Copyright © 1989 by David Godshall
  31.  
  32.  
  33.  
  34.  
  35.  
  36.      ___________
  37.       Legaleeze
  38.      ~~~~~~~~~~~
  39.      The program Zippy, the source to said program (not included), and the
  40.      documentation are Copyrighted by the author, David Godshall.
  41.      Permission is granted to individuals wishing to use the program in a
  42.      non-commercial setting for their own personal use.  Others must
  43.      contact the author and obtain permission in writing (see contribution
  44.      section at end of documentation) before using Zippy in a commercial
  45.      setting; the only exception to this being a "trial period", not to
  46.      exceed three weeks, during which you may use the program before
  47.      needing to register it.
  48.  
  49.      The author, David Godshall, can assume no responsibility for damage
  50.      caused or thought to have been caused, either directly or indirectly,
  51.      through use of the Zippy program.  This includes, but is not limited
  52.      to, loss of data, mechanical difficulties, insanity, and IBMitis.
  53.      Although I try to make the program as safe as possible/feasible, use
  54.      is strictly "at your own risk".
  55.  
  56.      ___________________
  57.       About The Program
  58.      ~~~~~~~~~~~~~~~~~~~
  59.      Zippy is a program designed to extract files from a .ZIP format
  60.      archive.  Even though there is currently no utility for the Amiga to
  61.      create ZIP archives, the ZIP format is such a flexible and powerful
  62.      format that it is not unusual to find BBSs with Amiga ZIP archives
  63.      (created using an IBM Zip program).  The advantages of ZIP over the
  64.      existing ARC standard is mainly that the ZIP format was designed not
  65.      only with MS-DOS computers in mind, but was created to work with just
  66.      about any computer.  Thus it does NOT limit the length of the
  67.      filename like ARC does!  That's the biggest advantage for us Amiga
  68.      users, but other advantages include the ability to store directory
  69.      structures (so when you unzip something, it will automatically create
  70.      the proper directories and put the files in them), better compression
  71.      techniques (ZIP files are often smaller than ARC files), the ability
  72.      to know what OS the file was zipped under so that when a text file is
  73.      unzipped the End-Of-Line characters can be fixed for you (i.e. MS-DOS
  74.      computers use both the CR and LF characters to indicate the end of a
  75.      line, whereas the Amiga uses only the LF character), the ability for
  76.      an archive to span multiple disks (mainly useful for disk backups and
  77.      stuff like that -- No ZIP program currently handles that possibility,
  78.      but it is definitely in the specs).  In fact, it appears that PKWare
  79.      (the inventors of the ZIP format) had the Amiga in mind when they
  80.      created the ZIP format, and are working (or have hired someone to
  81.      work on) Amiga versions of the PKZIP and PKUNZIP programs, which
  82.      would be the "official", full-featured versions.  Since they have not
  83.      been released yet (as of the day I am writing this), a couple of
  84.      UnZip programs have surfaced for the Amiga already.  Here is another
  85.      one.   NOTE:  PKAZip from PKWare *IS* now available, but Zippy still
  86.      has some advantages -- mainly the fact that it is CLI-based.
  87.  
  88.      But!  This is not *JUST* another UnZip program.  This is the richest,
  89.      most featured unzip program I've seen for the Amiga so far.  It can
  90.      take advantage of most of the features of the ZIP format and it fixes
  91.      a bug found in both of the other unzip programs around for the Amiga.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.      In fact, that bug was one of the main reasons I go started writing
  99.      this unzip program.  It seems the other unzip programs only had a 256
  100.      character buffer for the file comment, and didn't check to make sure
  101.      that the file comment would fit in the buffer.  The local BBS,
  102.      however, puts a 540 byte comment on each ZIP file on their board.
  103.      Needless to say, when the unzip programs tried to fit a 540 byte
  104.      comment in a space designed to accommodate only 256 bytes, something
  105.      had to give.  The program would overwrite vital code and then get a
  106.      visit from the friendly neighborhood GURU!
  107.  
  108.      Features of this unzip program include:
  109.         Full ARP style (superset of AmigaDOS set) wildcards
  110.         Works with self-extracting ZIP archives (currently only IBM)
  111.         Sort by any of ten list fields
  112.         Extract to disk, screen, printer, or nowhere (checksum test)
  113.         List the contents of the archive in any of four styles:
  114.            40 columns, 76 columns, 96 columns, or multiple line
  115.         Automatically create subdirectories to recreate original
  116.            directory structure (with switch to disable)
  117.  
  118.      Features not yet supported:
  119.         Does not set the filestamp of the files it extracts
  120.         Does not add file comments to the extracted files
  121.         Does no tweaking of End-Of-Line characters on text files
  122.         Does not support archives spanning multiple disks
  123.         Does not support encrypted files
  124.  
  125.      _____________
  126.       Using Zippy
  127.      ~~~~~~~~~~~~~
  128.      Zippy only works from the CLI, and has a dozen optional arguments and
  129.      switches you can use.  Zippy requires the presence of the ARP library.
  130.      If you don't already have arp.library in your LIBS: directory, be
  131.      sure to copy the enclosed arp.library file there, and then see to
  132.      getting the full ARP command replacements as soon as possible -- they
  133.      represent large improvements over the original AmigaDOS commands.
  134.           
  135.      The general format of ZIPPY is:
  136.      
  137.      1> ZIPPY <major-command> <qualifiers> <zipfile> <internal-files>
  138.  
  139.      The arguments can be in any order, and running ZIPPY without any
  140.      arguments is the same as using the HELP qualifier.  None of the
  141.      arguments or filenames are case sensitive.  The following
  142.      commands/qualifiers are allowed:
  143.      
  144.      <major-command>
  145.      ---------------     
  146.         X or -X or EXTRACT  = Extract file(s) (default)
  147.         C or -C or CRT      = Extract file(s) to the current window
  148.         P or -P or PRINT    = Extract file(s) to the printer (PRT:)
  149.         T or -T or TEST     = Test integrity of file(s)
  150.  
  151.         L or -L or LIST     = Display contents of archive: 40 columns
  152.         V or -V or VERBOSE  = Display contents of archive: 76 columns
  153.         W or -W or WIDELIST = Display contents of archive: 96 columns
  154.         F or -F or FULLLIST = Display contents of archive: Multiple lines
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.         -> Note that it IS valid to specify both an extraction command
  162.            and a display command, but not more than one of each type.
  163.  
  164.  
  165.      <qualifiers>
  166.      ------------
  167.         TO <pathname> = Put extracted files in the directory specified by
  168.                         <pathname> rather than the current directory.
  169.         SORT <field>  = Sort archive directory before extracting/listing
  170.            <field> can be one or more of the following characters:
  171.               N = Sort by filename
  172.               T = Sort by type of file (ASCII, Binary, encrypted)
  173.               C = Sort by compression scheme
  174.               S = Sort by size of original file
  175.               Z = Sort by size of compressed file
  176.               % = Sort by compression ration (best to worst)
  177.               D = Sort by date of file
  178.               K = Sort by checksum of file
  179.               / = Reverse direction of immediately following sort type
  180.         NOPATH        = Strip subdirectory info before processing filenames
  181.         NOCOMMENT     = Ignore any comments in archive
  182.         NOCODES       = Force Zippy to use "clean" ASCII -- No CSI codes
  183.         NOASK         = In situations where Zippy needs to ask a Y/N
  184.                         question, DON'T ask.  Instead:
  185.                           - If file to extract already exists, replace it
  186.                             
  187.      <zipfile>
  188.      ---------
  189.         This would be the name of the ZIP archive.  If you omit the .ZIP
  190.         suffix, Zippy will first try finding a file with the exact name
  191.         you specified; failing that it will add the .ZIP suffix and try
  192.         again.  You can include wildcards, in which case Zippy processes
  193.         all the matching files it finds in alphabetic order.  Note that
  194.         if you include wildcards, then Zippy will ONLY process files it
  195.         finds that end with the .ZIP suffix.
  196.         
  197.      <internal-files>
  198.      ----------------
  199.         Here you can specify one or more filenames to tell Zippy which
  200.         files in the ZIP file to consider for extraction/listing.  If you
  201.         don't specify any <internal-files>, Zippy assumes you want all the
  202.         files to be processed.  These filename can include wildcards.
  203.         
  204.         One exception to the above is if you preceed the filename with
  205.         an exclaimation mark.  In this case, the filename (without the
  206.         exclaimation mark) is used to decide which files should NOT be
  207.         processed.  For example, specifying "!*.info" would tell Zippy
  208.         to skip any files ending in ".info"
  209.  
  210.  
  211.  
  212.  
  213.  
  214.      ____________
  215.       Past Tense
  216.      ~~~~~~~~~~~~
  217.         Version 1.00
  218.            First major public release
  219.            Support for compression schemes up to Reduced (4)
  220.            Bug in UnReduction routine would crash machine periodically
  221.            
  222.         Version 1.21
  223.            Extraction routines completely encoded in Assembly Language
  224.            Fixed bug in UnReduction routine
  225.            Support for Implosion compression scheme
  226.            
  227.         Version 1.25
  228.            Fixed case-sensitive bug whereby specifying which files to
  229.               extract/list would not work
  230.            Added method to specify what files to NOT extract/list
  231.            If the file Zippy is about to extract already exists, ask the
  232.               user whether to overwrite the file or skip it
  233.            Added the NOASK qualifier
  234.  
  235.      ______________
  236.       Future Tense
  237.      ~~~~~~~~~~~~~~
  238.      Some items I plan to add/fix in the next version are:
  239.         Full Date/Time filestamp support
  240.         Adding file comment to extracted file
  241.         File Decryption
  242.         Text file tweaking (i.e. End-of-Line conversions)
  243.         Better handling of overwriting existing files, creating
  244.            subdirectories, etc.
  245.  
  246.      Some programs I plan to work on, in chronological order are:
  247.         Dizzy  - A no-frills version of Zippy, small and residentable
  248.         ZipExy - A program to make a ZIP file self-extracting
  249.         Zipper - A ZIP format archiver
  250.  
  251.      ___________________
  252.       The Gotcha <Grin>
  253.      ~~~~~~~~~~~~~~~~~~~
  254.      I have spent several hundred hours over the last many months writing
  255.      this program.  In addition, I don't have a lot of money, and WOULD
  256.      like to buy a hard drive sometime in the near future.  I might even
  257.      settle for a second floppy or a second meg of memory...  And all that
  258.      takes is...  everybody say it now...  MONEY!  Thus I am releasing
  259.      this program under the Shareware concept in the hopes that I'll be
  260.      able to get closer to my goal.  (You know a hard drive would REALLY
  261.      boost my productivity, and I could write more of these great
  262.      programs, and maybe get the "Zipper" program out before Christmas!
  263.      Grin.)  So...
  264.  
  265.              $25 gets you my gratitude, the latest version of Zippy,
  266.                 object code for the extraction routines so you can
  267.                 include them in your own program, Dizzy when it is
  268.                 finished, and the program to make a zip file
  269.                 self-extracting (if/when I get that done)  You will
  270.                 also be a registered "friend" and will receive
  271.                 notices of other programs or upgrades.
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.              $15 gets you all of the above (including my gratitude)
  279.                 except the object code.  You will also be a registered
  280.                 "friend" with all the duties and benefits that
  281.                 entails.
  282.  
  283.               $5 and a disk will get you the latest version of Zippy,
  284.                 and you still get my gratitude!  You will not,
  285.                 unfortunately, be a registered "friend", and while
  286.                 that does not mean I won't read your letters or
  287.                 answer your questions, I will have to take care of my
  288.                 registered "friends" first and handle my unregistered
  289.                 "friends" afterwards.
  290.  
  291.               $1 or any other amount will get you my gratitude.
  292.  
  293.  
  294.      If you decide not to send any money (no pressure...  just try not to
  295.      think about this poor individual slaving away on a single floppy
  296.      based system, swapping disks all day, falling asleep waiting for
  297.      compiles to finish...  Grin), you may still use Zippy with my
  298.      blessing, although you won't get any of the goodies mentioned above,
  299.      not even my gratitude!  Grin.  If you DO use Zippy at least several
  300.      times a month, however, please do register it.  Remember, that I *DO*
  301.      hold the copyright on the program, so you can't try to sell it as
  302.      your own or wantonly steal code from it or use it unregistered in a
  303.      commercial environment.  If you have any questions about that, just
  304.      let me know and I'll try to be accommodating.
  305.  
  306.      If you are going to be using this program in a commercial setting,
  307.      you are required to register at the $15 or $25 level.  Contact me for
  308.      information about registering multiple copies for a quantity discount
  309.      or site license.
  310.  
  311.      Please use the order form on the next page or the file OrderForm.
  312.      Just print it out and fill in the blanks or circle your responses.
  313.  
  314.  
  315.  
  316.                             Registration form for Zippy v1.25
  317.                             ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  318.      Name: ___________________________________________________  Sex:  M  F
  319.  
  320.      Address: __________________________________________  Apt: ___________
  321.  
  322.      City: ________________________  State: ____________  Zip: ___________
  323.  
  324.      Zippy will be used in a commercial environment:    Yes    No
  325.  
  326.      If so, where? _______________________________________________________
  327.  
  328.  
  329.      Computer:  A500   A1000   A2000   Other _____________________________
  330.  
  331.      Number of floppy drives:  1  2  3  4  Other _________________________
  332.  
  333.      Total capacity of hard drives _______________________________________
  334.  
  335.      Do you have a modem?  No  Yes   Model _______________________________
  336.  
  337.      Other neat peripherals ______________________________________________
  338.  
  339.          _________________________________________________________________
  340.  
  341.      Favorite use(s) for your computer ___________________________________
  342.  
  343.          _________________________________________________________________
  344.  
  345.          _________________________________________________________________
  346.  
  347.      Comments ____________________________________________________________
  348.  
  349.          _________________________________________________________________
  350.  
  351.          _________________________________________________________________
  352.  
  353.      May I release this info to other individuals (not companies)
  354.      interested in corresponding with other Amiga users?  Yes  No
  355.  
  356.      I am sending my contribution of:  (Please circle)
  357.        $___ because I believe in supporting Shareware!
  358.         $25 for the full Zippy registration, next version, & object code
  359.         $15 for the full Zippy registration & next version
  360.          $5 and a disk for the latest version of Zippy
  361.        $___ for your gratitude
  362.          $0 just to let you know that I have tried the program
  363.             and have some comments.  Sorry I can't give any
  364.             donation at this point.
  365.  
  366.      Total enclosed: $_______________________________
  367.  
  368.  
  369.      Please send this form and check or money order to:
  370.         David Godshall
  371.         401 S. Main St.
  372.         Hesston, KS  67062
  373.